package com.ruoyi.web.controller.common;

import java.awt.image.BufferedImage;
import java.io.IOException;
import java.util.concurrent.TimeUnit;
import javax.annotation.Resource;
import javax.imageio.ImageIO;
import javax.servlet.http.HttpServletResponse;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.FastByteArrayOutputStream;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import com.google.code.kaptcha.Producer;
import com.ruoyi.common.config.RuoYiConfig;
import com.ruoyi.common.constant.CacheConstants;
import com.ruoyi.common.constant.Constants;
import com.ruoyi.common.core.domain.AjaxResult;
import com.ruoyi.common.core.redis.RedisCache;
import com.ruoyi.common.utils.sign.Base64;
import com.ruoyi.common.utils.uuid.IdUtils;
import com.ruoyi.system.service.ISysConfigService;

/**
 * 验证码操作处理
 * 处理验证码生成的请求，返回验证码图片及其相关信息。
 *
 * @author ruoyi
 */
@RestController
public class CaptchaController
{
    // 注入验证码生成器，用于生成不同类型的验证码（数学运算或字符）
    @Resource(name = "captchaProducer")
    private Producer captchaProducer;

    @Resource(name = "captchaProducerMath")
    private Producer captchaProducerMath;

    // 注入Redis缓存操作类，用于将验证码保存到Redis缓存中
    @Autowired
    private RedisCache redisCache;

    // 注入系统配置服务类，用于读取是否启用验证码的配置
    @Autowired
    private ISysConfigService configService;

    /**
     * 生成验证码
     * 该方法通过 GET 请求生成验证码图片，并返回给前端，验证是否启用验证码。
     *
     * @param response HttpServletResponse，响应对象，用于输出图片
     * @return 返回验证码图片的 Base64 编码及 UUID，及是否启用验证码的状态
     * @throws IOException 如果图片生成或写出过程中发生异常
     */
    @GetMapping("/captchaImage")
    public AjaxResult getCode(HttpServletResponse response) throws IOException
    {
        // 创建一个 AjaxResult 对象，用于返回结果
        AjaxResult ajax = AjaxResult.success();

        // 检查是否启用验证码配置
        boolean captchaEnabled = configService.selectCaptchaEnabled();
        ajax.put("captchaEnabled", captchaEnabled);

        // 如果没有启用验证码，直接返回不启用状态
        if (!captchaEnabled)
        {
            return ajax;
        }

        // 生成一个 UUID，用于标识此次验证码
        String uuid = IdUtils.simpleUUID();
        String verifyKey = CacheConstants.CAPTCHA_CODE_KEY + uuid;

        String capStr = null, code = null;
        BufferedImage image = null;

        // 获取系统配置中的验证码类型（数学运算或字符）
        String captchaType = RuoYiConfig.getCaptchaType();

        // 如果验证码类型是数学运算，则生成数学运算类型的验证码
        if ("math".equals(captchaType))
        {
            // 创建一个数学运算类型的验证码文本，例如：3 + 5 = ?
            String capText = captchaProducerMath.createText();
            // 提取出数学运算文本与结果
            capStr = capText.substring(0, capText.lastIndexOf("@"));
            code = capText.substring(capText.lastIndexOf("@") + 1);
            // 生成数学运算的验证码图片
            image = captchaProducerMath.createImage(capStr);
        }
        // 如果验证码类型是字符，则生成字符类型的验证码
        else if ("char".equals(captchaType))
        {
            // 生成字符验证码文本
            capStr = code = captchaProducer.createText();
            // 生成字符验证码图片
            image = captchaProducer.createImage(capStr);
        }

        // 将验证码保存到 Redis 中，设置有效期为 5 分钟
        redisCache.setCacheObject(verifyKey, code, Constants.CAPTCHA_EXPIRATION, TimeUnit.MINUTES);

        // 使用 FastByteArrayOutputStream 将生成的验证码图片写入到字节数组中
        FastByteArrayOutputStream os = new FastByteArrayOutputStream();
        try
        {
            // 将图片写入输出流（格式为 JPG）
            ImageIO.write(image, "jpg", os);
        }
        catch (IOException e)
        {
            // 如果发生 I/O 错误，返回错误信息
            return AjaxResult.error(e.getMessage());
        }

        // 将验证码的 UUID 和图片的 Base64 编码返回给前端
        ajax.put("uuid", uuid);
        ajax.put("img", Base64.encode(os.toByteArray()));

        // 返回包含验证码信息的 AjaxResult
        return ajax;
    }
}
